From: Stefan Kangas <stefankangas@gmail.com>
Date: Sat, 22 Feb 2025 13:41:34 +0000 (+0100)
Subject: ; * admin/check-doc-strings: Add note for future development.
X-Git-Tag: archive/raspbian/1%30.2+1-2+rpi1^2~2^2~24^2~279
X-Git-Url: https://dgit.raspbian.org/%22http://www.example.com/cgi/%22/%22http:/www.example.com/cgi/%22?a=commitdiff_plain;h=0cc651acddb87180357ab8ff4adcbac8d6174e50;p=emacs.git

; * admin/check-doc-strings: Add note for future development.
---

diff --git a/admin/check-doc-strings b/admin/check-doc-strings
index b119b50885b..dee7ded8237 100755
--- a/admin/check-doc-strings
+++ b/admin/check-doc-strings
@@ -5,6 +5,18 @@ eval 'exec perl -S $0 "$@"' # Portability kludge
 # Author: Martin Buchholz
 # This program is in the public domain.
 
+# NOTE ADDED 2025-02-22:
+#
+# This is an old script that doesn't necessarily work very well with
+# today's sources.  If anyone wants to fix it up, it might be worth the
+# effort, as it could help catch some mistakes that we have overlooked.
+#
+# If you want to work on this, consider fundamentally rethinking the
+# approach.  Instead of flagging anything that *might* be an error,
+# maybe it should flag only things that we are *sure* are an error.
+# That would make it possible to run this as a matter of routine, just
+# as we already do with codespell (see "admin/run-codespell").
+
 use strict;
 use warnings;
 use POSIX;